home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / relnotes / dmedia_dev / ch05.z / ch05
Encoding:
Text File  |  1997-09-04  |  5.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        5.  _A_u_d_i_o__L_i_b_r_a_r_y
  9.  
  10.        This chapter lists information about the IRIS Audio Library
  11.        programming interface included in the IRIS Digital Media
  12.        Development Environment.  It includes changes, additions,
  13.        and bug fixes since the IRIX 5.3 release, and known
  14.        problems, workarounds, and caveats.
  15.  
  16.        The IRIS Audio Library is a C language procedure call
  17.        library that allows application programs to read digital
  18.        audio input data from and write audio output data to the
  19.        IRIS Audio Processor.  The library also includes procedures
  20.        for reading and writing control parameters in the Audio
  21.        Processor, such as the global input and output sample rates.
  22.  
  23.        The Audio Library is shipped as a statically-linked library
  24.        (/_u_s_r/_l_i_b/_l_i_b_a_u_d_i_o._a) included with the IRIX Development
  25.        Option software.
  26.  
  27.        Please consult the _I_R_I_S _D_i_g_i_t_a_l _M_e_d_i_a _P_r_o_g_r_a_m_m_i_n_g _G_u_i_d_e for
  28.        an introduction to programming with Audio Library and a
  29.        detailed description of its functions.
  30.  
  31.        The on-line manual page _A_L_i_n_t_r_o(_3_d_m) contains a short
  32.        overview of library functionality and a complete list of the
  33.        procedure calls.
  34.  
  35.  
  36.        5.1  _C_h_a_n_g_e_s__a_n_d__A_d_d_i_t_i_o_n_s
  37.  
  38.        This section lists changes/additions to the Audio Library,
  39.        audio driver, and accompanying example source code since the
  40.        IRIX 5.3.
  41.  
  42.           +o A version of the Audio Library is now available with
  43.             support for 64-bit address spaces (the -64 compiler
  44.             option). Install dmedia_dev.sw64.lib to get this
  45.             version. It will be installed in /usr/lib64.
  46.  
  47.           +o A version of the Audio Library is now available with
  48.             support for the n32 ABI (and therefore 32-bit
  49.             applications compiled with -mips3 or -mips4). Install
  50.             dmedia_dev.sw32.lib to get this version. It will be
  51.             installed in /usr/lib32.
  52.  
  53.           +o The IRIX 6.2 version of the Audio Library incorporates
  54.             a number of performance enhancements. Most notably, the
  55.             performance of the Audio Library with floating-point
  56.             and double-precision samples has been considerably
  57.             improved.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        5.2  _B_u_g__F_i_x_e_s
  75.  
  76.        This section lists the bugs fixed since the last release of
  77.        the IRIS Audio Library.  Some of the descriptions are
  78.        followed by a Silicon Graphics bug report number in the form
  79.        (SCR XXXX).
  80.  
  81.           +o A problem existed in IRIX 5.3 where small errors could
  82.             be introduced in ALgetframenumber when input and output
  83.             ports were in use simultaneously. This has been fixed.
  84.             (SCR 288639)
  85.  
  86.           +o In four-channel mode, at sample-rates derived from
  87.             44.1kHz, under certain conditions the front and back
  88.             stereo pairs could become swapped. This has been fixed
  89.             (SCR 315007).
  90.  
  91.           +o When using 24-bit I/O, the maximum sample value was
  92.             limited to 0x7fff00 instead of 0x7fffff. This
  93.             restriction has been removed (SCR 343466).
  94.  
  95.        5.3  _K_n_o_w_n__P_r_o_b_l_e_m_s__a_n_d__W_o_r_k_a_r_o_u_n_d_s
  96.  
  97.        This section lists problems in the Audio Library software
  98.        and ways to work around them.
  99.  
  100.           +o When there is nothing physically connected to the
  101.             digital I/O jack, it is meaningless to set the system
  102.             sample rates in the following three ways:
  103.  
  104.                +o output sample rate set to match the input sample
  105.                  rate while using digital input as the system
  106.                  input.
  107.  
  108.                +o input sample rate set to the digital rate and the
  109.                  output rate set to match the input rate.
  110.  
  111.                +o input sample rate set to the digital rate and the
  112.                  output rate set to the digital input rate.
  113.  
  114.                +o When the system is placed in one of these states,
  115.                  the behavior cannot be predicted. Performing any
  116.                  of the actions listed above should be avoided by
  117.                  application programs.
  118.  
  119.        5.4  _P_r_o_g_r_a_m_m_i_n_g__E_x_a_m_p_l_e_s
  120.  
  121.        The _d_m_e_d_i_a__d_e_v._s_r_c._e_x_a_m_p_l_e_s subsystem contains several
  122.        source code examples for programming with the Audio Library.
  123.        The source code is available in the directory
  124.        /_u_s_r/_s_h_a_r_e/_s_r_c/_d_m_e_d_i_a/_a_u_d_i_o.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        The _d_m_e_d_i_a__d_e_v._s_r_c._t_o_o_l_s subsystem includes the source code
  141.        for the standard aaaauuuuddddiiiiooooppppaaaannnneeeellll((((1111)))) and ssssoooouuuunnnnddddppppllllaaaayyyyeeeerrrr((((1111)))) tools
  142.        which are shipped with IRIX 6.2. The source code is
  143.        installed in the directories
  144.        /_u_s_r/_s_h_a_r_e/_s_r_c/_d_m_e_d_i_a/{_a_u_d_i_o_p_a_n_e_l,_s_o_u_n_d_p_l_a_y_e_r}.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.